revelplayer/com.reveldigital.player.view/[androidJvm]GalleryView

GalleryView

open class GalleryView : RelativeLayout, RevelControl, DownloadFeedTask2.OnCompleted, DownloadImageTask2.OnCompleted, QueryVideoInfosTask.OnCompleted, DownloadFileTask2.OnCompleted, PlaceExchangeAdRequestTask.OnCompleted, OnCommandListener, VistarAdRequestTask.OnCompleted, PlayedHandler

A custom RelativeLayout that displays a gallery of different types of media, including images, videos, and web content.

The GalleryView is responsible for managing a playlist of media sources defined by a com.reveldigital.player.api.Module. It handles the loading, display, and transitioning between these sources. It supports various content types such as local files, remote URLs, RSS feeds, YouTube videos, and content from ad platforms like Place Exchange and Vistar Media.

Key functionalities include:

Inflating appropriate layouts based on device capabilities and preferences (e.g., SurfaceView vs. TextureView, ExoPlayer).
Managing playback state (start, stop, pause, next, previous).
Handling transitions between media items (e.g., fade animations).
Downloading and caching media content.
Interacting with web content via a Javascript interface.
Listening to and dispatching playback events (e.g., item played, playlist completed).
Integrating with external ad services for dynamic ad insertion.
Responding to commands (e.g., from a remote control or server).

This view implements various listener interfaces to react to asynchronous operations like downloads and ad requests, and RevelControl to provide a standardized interface for controlling media playback.

See also

PlaylistListener

PlayedListener

Constructors

constructor(context: Context, attrs: AttributeSet)

Constructor for inflating the view from XML.

constructor(context: Context, attrs: AttributeSet, defStyle: Int)

Constructor for inflating the view from XML with a default style.

constructor(context: Context, module: Module)

Programmatic constructor for creating a GalleryView instance.

Properties

open val isStarted: Boolean

transitionDuration

open var transitionDuration: Int

Functions

addOnCallbackListener

open fun addOnCallbackListener(listener: OnCallbackListener)

Adds an OnCallbackListener to the list of listeners that will be notified of callback events.

addPlaylistListener

open fun addPlaylistListener(listener: PlaylistListener)

Registers a `PlaylistListener` to receive notifications about playlist events.

open fun dispose()

Releases any resources held by this control and prepares it for removal or permanent deactivation.

open fun getName(): String

Gets the unique name assigned to this control.

open fun getOptions(): Iterator<out Option>

Gets an iterator over the configuration s for this control.

open fun getPlaylist(): Playlist

Gets the associated with this control, if any.

open fun getSource(): Source

Gets the current source from the playlist.

open fun getType(): ModuleType

Gets the type of the underlying module or content associated with this control.

open fun getVideoView(): VideoViewImpl

Gets the current VideoViewImpl used by this presenter.

open fun getZIndex(): Int

Gets the Z-index (stacking order) of this control.

open fun initialize(module: Module)

Initializes the control with its associated module context.

open fun isAutoStart(): Boolean

Checks if this control is configured to start its operation automatically after #initialize(Module) initialization.

open fun next()

Moves to the next media source in the playlist.

onAdRequestCompleted

open fun onAdRequestCompleted(response: AdResponse, sourceId: String)

open fun onCommand(name: String, value: String)

Invoked when a command is received by a component this listener is registered with.

onDownloadFeedCompleted

open fun onDownloadFeedCompleted(feed: Feed)

onDownloadFileCompleted

open fun onDownloadFileCompleted(file: File)

onDownloadImageCompleted

open fun onDownloadImageCompleted(view: ImageView, bitmap: Bitmap)

onQueryAdRequestCompleted

open fun onQueryAdRequestCompleted(response: AdRequestResponse)

onQueryVideoInfosCompleted

open fun onQueryVideoInfosCompleted(videoInfos: List<VideoInfo>, source: Source)

open fun pause()

Pause the video playback.

open fun previous()

Move to the previous source in the playlist.

registerPlayedListener

open fun registerPlayedListener(listener: PlayedListener)

Registers a listener to be notified when a played event occurs.

removeOnCallbackListener

open fun removeOnCallbackListener(listener: OnCallbackListener)

Removes an OnCallbackListener from the list of listeners that are notified when an event occurs.

removePlaylistListener

open fun removePlaylistListener(listener: PlaylistListener)

Removes a playlist listener that was previously added with addPlaylistListener.

open fun resume()

Resumes video playback if it was previously paused.

open fun seekTo(position: Int)

Seeks to the specified position in the video.

open fun setAutoStart(flag: Boolean)

Sets whether this control should start its operation automatically after #initialize(Module) initialization.

open fun setLooping(flag: Boolean)

Sets whether the video should loop seamlessly.

open fun setSource(source: Source)

Sets and plays the specified Source in the playlist.

open fun setSource(idx: Int)

Sets and plays the source specified by playlist index (0 based).

open fun setSource(source: Source, play: Boolean)

Sets the current source.

open fun setSource(idx: Int, play: Boolean)

Set the source by index (0 based).

open fun setVolume(volume: Float)

Sets the volume for audio/video sources.

open fun start()

Starts or resumes the active operation of this control.

open fun startAt(source: Source)

Starts playing at the specified Source.

open fun startAt(idx: Int)

Starts playing at the specified playlist index.

open fun stop()

Stops or pauses the active operation of this control.